home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmCreatePopupMenu.z / XmCreatePopupMenu
Encoding:
Text File  |  2003-11-18  |  4.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_C_r_e_a_t_e_P_o_p_u_p_M_e_n_u - A    RowColumn widget convenience creation
  10.       function
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <Xm/RowColumn.h>
  14.  
  15.       Widget XmCreatePopupMenu (ppppaaaarrrreeeennnntttt,,,, nnnnaaaammmmeeee,,,, aaaarrrrgggglllliiiisssstttt,,,, aaaarrrrggggccccoooouuuunnnntttt)
  16.            _W_i_d_g_e_t     ppppaaaarrrreeeennnntttt;
  17.            _S_t_r_i_n_g     nnnnaaaammmmeeee;
  18.            _A_r_g_L_i_s_t     aaaarrrrgggglllliiiisssstttt;
  19.            _C_a_r_d_i_n_a_l     aaaarrrrggggccccoooouuuunnnntttt;
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.       _X_m_C_r_e_a_t_e_P_o_p_u_p_M_e_n_u creates an instance    of a RowColumn widget
  23.       of type _X_m_M_E_N_U__P_O_P_U_P and returns the associated widget ID.
  24.       When using this function to create the Popup MenuPane, a
  25.       MenuShell widget is automatically created as the parent of
  26.       the MenuPane.     The parent of the MenuShell widget is the
  27.       widget indicated by the ppppaaaarrrreeeennnntttt parameter.
  28.  
  29.       _X_m_C_r_e_a_t_e_P_o_p_u_p_M_e_n_u is provided    as a convenience function for
  30.       creating RowColumn widgets configured    to operate as Popup
  31.       MenuPanes and    is not implemented as a    separate widget    class.
  32.  
  33.       The PopupMenu    is used    as the first MenuPane within a
  34.       PopupMenu system; all    other MenuPanes    are of the Pulldown
  35.       type.     A Popup MenuPane displays a 3-D shadow, unless    the
  36.       feature is disabled by the application.  The shadow appears
  37.       around the edge of the MenuPane.
  38.  
  39.       The Popup MenuPane must be created as    the child of a
  40.       MenuShell widget in order to function    properly when it is
  41.       incorporated into a menu.  If    the application    uses this
  42.       convenience function for creating a Popup MenuPane, the
  43.       MenuShell is automatically created as    the real parent    of the
  44.       MenuPane.  If    the application    does not use this convenience
  45.       function to create the RowColumn to function as a Popup
  46.       MenuPane, it is the application's responsibility to create
  47.       the MenuShell    widget.
  48.  
  49.       To access the    PopupMenu, the application must    first position
  50.       the widget using the _X_m_M_e_n_u_P_o_s_i_t_i_o_n function and then    manage
  51.       it using _X_t_M_a_n_a_g_e_C_h_i_l_d.
  52.  
  53.       ppppaaaarrrreeeennnntttt
  54.            Specifies the parent widget ID
  55.  
  56.       nnnnaaaammmmeeee Specifies the name of the created widget
  57.  
  58.       aaaarrrrgggglllliiiisssstttt
  59.            Specifies the argument list
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333XXXX))))
  71.  
  72.  
  73.  
  74.       aaaarrrrggggccccoooouuuunnnntttt
  75.            Specifies the number of attribute/value pairs in    the
  76.            argument    list (aaaarrrrgggglllliiiisssstttt)
  77.  
  78.       Popup    MenuPanes support tear-off capabilities    for tear-off
  79.       menus    through    _X_m_R_o_w_C_o_l_u_m_n resources.    For a complete
  80.       definition of    RowColumn and its associated resources,    see
  81.       _X_m_R_o_w_C_o_l_u_m_n(_3_X).
  82.  
  83.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  84.       Returns the RowColumn    widget ID.
  85.  
  86.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  87.       _X_m_C_r_e_a_t_e_S_i_m_p_l_e_P_o_p_u_p_M_e_n_u(_3_X), _X_m_M_e_n_u_P_o_s_i_t_i_o_n(_3_X),
  88.       _X_m_M_e_n_u_S_h_e_l_l(_3_X), _X_m_R_o_w_C_o_l_u_m_n(_3_X), and
  89.       _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_P_o_p_u_p_M_e_n_u(_3_X).
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.